home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 5 / BBS in a Box -Volume V (BBS in a Box) (April 1992).iso / Files / Prog / S / ShowCInit.cpt / ShowCInit / ShowCInit.doc / ShowCInit.doc
Encoding:
Text File  |  1989-02-02  |  8.6 KB  |  172 lines  |  [APPL/DcaP]
  1. --------------------------------------------------------------------------
  2.                                                           ShowCInit™ 1.1
  3.                                                           ---------
  4.                                                           Written by:
  5.                                          Joseph J. Sternlicht and Andrew Diaz
  6. --------------------------------------------------------------------------
  7.  
  8.  
  9. About ShowCInit...
  10. ----------------
  11.  
  12. ShowCInit is a precompiled INIT which displays color or black&white icons on 
  13. the desktop at startup.  It is fully compatible with ShowInit (or "Thanks Paul") and 
  14. the Mac family (with the possible exception of those with 64K ROMs).  It also 
  15. provides seven additional features:
  16.  
  17. 1.  It will wrap icons when they reach the end of the screen (starting one row up
  18.      and to the left).
  19. 2.  It facilitates the animation of color or black&white icons.
  20. 3.  It facilitates drawing multiple color or black&white icons.
  21. 4.  It provides an option to play a 'snd '.
  22. 5.  It provides an option to sysbeep the user.
  23. 6.  It doesn't have to be compiled because it already is, and gets its information
  24.      from a resource.
  25.      (for which we include a ResEdit template)
  26. 7.  And it provides an option to loop through your animation until the mouse button
  27.      is pressed.
  28.      (handy for alerting the user, also SysBeeps each time if sysbeep option is set)
  29.  
  30.  
  31. Files Included...
  32. --------------
  33.  
  34. 1.  ShowCInit:  This file contains the INIT which displays an color or black and
  35.      white icon in animation showing an apple.
  36. 2.  ShowCInit.doc:  You're reading it!
  37. 3.  'icn#' TMPL:  ResEdit template for creating 'icn#' resources for use with this
  38.      INIT.
  39.  
  40.  
  41. Using ShowCInit...
  42. ----------------
  43.  
  44. To use ShowCInit, place the INIT resource into a file in your system folder (this 
  45. can be done with ResEdit).  The file should be of type cdev or INIT (otherwise, the 
  46. system won't look at it when it boots up!).  Place your cicn's or ICN#'s in the file 
  47. as well.  Now, you need to create a resource called 'icn#'.  This is the instruction 
  48. list for ShowCInit. If you have not already done so, copy the 'icn#' template which 
  49. came with this into your ResEdit application file (inside ResEdit itself).  Close 
  50. ResEdit to save the changes and go back to your INIT file.
  51.  
  52. Now add a new resource by selecting new from the file menu.  Select the 'icn#' 
  53. resource and select new again.  Now you have an empty resource which you need to 
  54. fill as follows:
  55.  
  56. 1.   Number of cicn's:  This is the number of color icons to be used in the animation,
  57.       use one for no animation.
  58. 2.   Color?:  If true, ShowCInit plots color icons on color machines.  If false, it
  59.       plots ICN#'s on all machines.  If a machine doesn't have color QuickDraw, it
  60.       tries to plot ICN#'s if they exist.
  61. 3.   Delay:  This is the number of ticks (1/60 of a second) to delay between the
  62.       plotting of each icon (recommend 10, or 30 for a flashing effect).
  63. 4.   Animation:  If true, then icons are drawn at same location, otherwise they
  64.       appear one after another horizontally.
  65. 5.   Wait for Mouse Down:  True means the animation repeats until the mouse is
  66.       pressed.
  67. 6.   SysBeep:  True means a sysbeep will be played.
  68. 7.   Sound:  True means a 'snd ' resource will be played.
  69. 8.   Sound ID:  If Sound is true, then the ID of the 'snd ' to be played goes here.
  70. 9.   Unused:  Saved for future purposes.
  71. 10. From here on, are the ID's of the 'cicn' resources to be used for animation in the
  72.       order that they will be drawn.  MAKE SURE THERE ARE AT LEAST AS MANY CICN
  73.       ID'S AS SPECIFIED IN THE NUMBER OF CICN'S!!!  (as sysbeep will play if a cicn
  74.       cannot be found)
  75.  
  76. Lastly, it is VITAL that you change the ID of the 'icn#' resource to 999 and begin 
  77. the name of the INIT with ShowCInit (e.g. ShowCInit1, ShowCInit 2, etc.).  The ID of 
  78. the INIT itself doesn't matter at all for its functioning but the order in which they 
  79. appear may matter in your application (if it does, you already know what we 
  80. mean).  It seems that the first INIT listed, is the last INIT run; the ID's don't seem 
  81. to matter at all.
  82.  
  83.  
  84. Advice...
  85. --------
  86.  
  87. We suggest that you create corresponding ICN#'s.  This way, if you run on a non-
  88. color QuickDraw Mac, you will at least see the black&white icons.  In the future, 
  89. we will automatically plot the black&white version of the color icon; we had a 
  90. problem with the base address of the iconBMap (always zero?).  But for now, this 
  91. works and any changes will be compatible with all previous versions!  The 
  92. black&white icons will be drawn unless "Color?" is true.  Also, IM recommends 
  93. that cicn's should be purgeable.  If you have any problems, call, 9-5, M-F, (407) 
  94. 727-7737.
  95.  
  96.  
  97. Terms...
  98. -------
  99.  
  100. We provide the template free of charge. However, we put some effort into 
  101. developing this INIT.  We ask that if you want to use this INIT for personal use that 
  102. you send us the whopping amount of $1.  That's all we ask!  Unless you can afford 
  103. $2, since there are two of us.  With that one dollar, and a little searching for a 
  104. cheap enough machine, we can each by a soda between classes.  
  105.  
  106. If you would like to use this INIT for a product, we require $10 per product or $50 
  107. for unlimited use.
  108.  
  109. Send To:     Joe Sternlicht
  110.                  3630 Misty Oak Drive  #1607
  111.                  Melbourne, FL  32901
  112.  
  113.  
  114. For NON-programmers...
  115. ---------------------
  116.  
  117. You do not need to know how to program to use this!  This INIT requires no 
  118. programming experience, just a little experience with ResEdit.  Here's an idea:  Use 
  119. ResEdit to copy the 'icn#' TMPL into ResEdit itself and close ResEdit.  Use ResEdit 
  120. to create a file of type INIT and copy the ShowCInit into the file.  In that file, 
  121. create a few ICN#'s or copy some cicn's from another file.  Now, create a new 
  122. resource of type 'icn#'.  Use Get Info to renumber the ID to 999 and rename it to 
  123. whatever you want; so long as it starts with 'ShowCInit'.  Next, fill in the 
  124. template of the icn# resource.  Set the number of icons, choose color if you are 
  125. using color icons, set the delay between icons to 10, choose animation to have the 
  126. icons drawn one on top of the other, set sysbeep to false, set sound to false, skip 
  127. sound ID and unused, now click on the stars (*) at the bottom and select new from 
  128. the file menu once for every icon you want to draw.  In the boxes to the right, type 
  129. the ID's of the icons in the order you want them drawn.  Close and save the file, 
  130. and place it in your system folder.  You've just created a little INIT without 
  131. programming!  Use ResEdit to experiment with some of the fields in the icn# 
  132. resource.  Try copying a 'snd ' resource into the file and set the icn# resource 
  133. fields appropriately.
  134.  
  135.  
  136. On the side...
  137. ------------
  138.  
  139. Did you ever wonder how those icons were shown on the desktop at startup?  Well, 
  140. we did.  We came across assembly code for ShowInit, and would like to thank Paul 
  141. Mercer ('Thanks Paul') for it.  We learned a little about drawing on the desktop at 
  142. startup and how he maintained the position of the next icon.  As computer 
  143. scientists (or at least we are studying to be) we want a tool, written in a high 
  144. level language for maintainability purposes, so we don't have to worry about 
  145. writing new code for every application we write.  Also, we felt that the icons 
  146. should wrap around the screen rather than being clipped.  So, we rewrote it in 
  147. 100% Lightspeed C (no assembly!).  We added a few more optional features and will 
  148. add more as time goes by to make life easier.  All versions WILL maintain full 
  149. compatibility.  We expect everyone to use this INIT to show their icons at startup.  
  150. So, with that in mind, we will continue to optimize and enhance it as you request.
  151.  
  152. If you are interested in the source code, it is written in LSC as stated earlier and 
  153. is well commented as to what it is we are doing and why.  We'll send it to you for 
  154. $25.  If you do purchase it, do not upload it, do not give it away; it is not public 
  155. domain.  The INIT itself isn't either; it costs $1 for personal use, $10 for 
  156. professional use.
  157.  
  158.  
  159. Update...
  160. --------
  161.  
  162. Unfortunately, we let an old version get out.  The only problem with the old version 
  163. was that it crashed if you waited too long when using the Wait Mouse Down option.  
  164. The proper version is 1.1.  You can tell if you have an old version by using ResEdit 
  165. to look at the data in the INIT towards the end, in the copyright statement.  If it 
  166. doesn't have a version number or has on less than 1.1, then it is old and you should 
  167. replace it.
  168.  
  169.  
  170.                                                     Thanks, have fun, and be creative,
  171.                                                    Joe Sternlicht and Andrew Diaz, GraF/X, Intl.
  172.